Nividium Auto Debris Harvestor 2 for X3 Reunion, Script Package.

Name of Script Package	Auto Debris Harvestor 2
Version Number		2.00 
Date Released		9/28/2007
Last Updated		n/a
Script Created For	X3 Reunion v 2.0.02
File Package Available	X3 Script Installer "SPK"

Description:

Auto Debris Harvestor 2 adds a custom ship command called [Harvest Rock Debris].  This commands a Player owned ship to begin harvesting rock debris "clusters".  It is completely automatic and is run by onboard computer software rather than a pilot.  This means that you do not have to pay for a pilot's wages or cut them in on any of the profits.  The Auto Debris Harvestor 2 software will: buy fuel for the ship, repair the ship, monitor for enemy attack and Jump-Out of harms way if attacked and finally sell or unload the minerals that it harvests.  Just press the Command button and select a Sector for it to work in.  It will continue working there until all the debris clusters are gone (except for debris of zero Yield, which it ignores).  It will jumpdrive back and forth harvesting and selling by itself (very quickly).  You will make friends and increase Notoriety very quickly with Auto Debris Harvestor working for you.  You will also make alot of credits very quickly too.  This new version adds some features and removed some other internal features.

Features:

The [Harvest Rock Debris] Command allows your ships to automatically:

- Monitor the level of, search for and buy fuel for the ship.
- If the Harvestor has a regular Station as a Homebase then this Homebase needs to have "credits" to enable the Harvestor to buy Fuel.  Otherwise the Harvestor will fly all the way to a SPP and then realize there is not enough "credits" then it will fly all the way back again and start working without any Fuel.  Then it will do the same again after it dumps it's load.  This is a mining script not a Station Management script, so remember to put some "credits" in your Stations.
- If the Harvestor has another Ship as it's Homebase, then the Player will pay for Fuel.  If the Player does not have enough "credits", then the Harvestor will behave as described above.
- Monitor the condition of ship hull, search for and buy ship repairs, if needed.
- Monitor for enemy attackers and Jumpdrive out (2 sectors away), if under attack.
- If ship loses it's Jumpdrive or has insufficient fuel for an Emergency Jump, then it Docks.
- Jumpdrive to and from sectors harvesting and selling.
- You can use any ship as a Harvestor as long as it can carry XL ware ie minerals.
- You can assign another ship as the Homebase of the Harvestor if it can carry XL ware.
- If a ship uses another ship as it's Homebase, then the [Ship-Homebase] needs to have a "marker/s" of 1 unit of the intended target mineral onboard in order to let it's children Harvestors know what kind of mineral to collect. Don't lose your "markers".  So, you will need to somehow get these marker minerals into the TL, Carrier, Battleship.  How, the heck are you going to do that? You need to dock at a Trading/Equipment/Headquarters that already has Ore/Silicon/Nividium stocked in it and transfer 1 unit of each mineral intended to be harvested, out over to the intended Ship-Homebase.  This just makes it harder for you to get started with using a Ship as a Homebase.
- You can assign a station/dock/factory as the Homebase of the Harvestor if it uses minerals.
- You can assign a Headquarters as the Homebase.  But beware, Harvestors do NOT stop delivering to a Headquarters even if some other setting is set to stop MK3, CAD, CAG or Agents from delivering.
- If this bothers you, don't use the Auto Debris Harvestor with your Headquarters.
- If the Homebase uses multiple minerals, the Harvestor will collect minerals randomly.  Ie: it will pick a mineral and then collect that mineral till it's cargo bay is full then sell/unload.  Then it will pick a mineral again, could be the same or it might be one of the other minerals.
- If the Harvestor has no Homebase assigned, it will randomly pick a mineral to collect and when it's cargo bay is full, it will search for buyers within a 5 Sector radius and sell the wares.
- Non Homebase assigned Harvestor will also sell to your other stations/Headquarters if your stations/Headquarters prices are set higher than NPC stations in the area.
- It is not uncommon to see a Harvestor in "Idle" mode.  This is part of it's normal behaviour.
- The Harvestor collects minerals by rock debris "clusters" and will stop collecting if a "cluster" volume is greater than the free space available in it's cargo bay.  So a Harvestor may not fill the Cargo Hold to it's maximum capacity.  This avoids wasting a good "cluster".  For referrance, your cargo hold needs enough space to add a "cluster".  The volume of a "cluster" is as follows:

Ore Cluster = 300 ware count units and needs 2400 cargo bay volume to store it.
Silicon Cluster = 200 ware count units and needs 3600 cargo bay volume to store it.
Nividium Cluster = 100 ware count units and needs 400 cargo bay volume to store it.

- Harvestors auto coordinate their flight plans with other Harvestors to avoid selling to the same Stations at the same time.
- Only Player owned ships can use this command.  The Playership cannot though.
- Known and unusual "Bug".  If you are "In Sector" while the Harvestors are working, the "debris cluster" they collect will not vanish until you are "Out Of Sector".  Graphics Card problem, I guess, who knows.


The Command ends if the Harvestor cannot find anymore debris to harvest, it is attacked and had to make an Emergency Jump-Out, or if you issue a new Command ie: Dock, Fly, Standby or Jump etc.

Required Equipment:

- Any class ship that can transport minerals ie XL cargo bay class
- Jumpdrive
- Transporter Device
- Mineral Scanner

Installation: Use the X3 Plugin Manager/Installer.

Uninstall: Use the X3 Plugin Manager/Installer.  Uninstall any previous versions before installing newer versions of Auto Debris Harvestor.  There is code to auto-restart the Harvestors when a new version is installed.

Version History:
Version 2.00  Release 10/16/2007.
Version 1.00  Release 9/28/2007.

Command Slots Used: "<t id="747">COMMAND_TYPE_CUSTOM_47</t>"

Text File Used: 448085.pck
